home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringComponentCreate.z / XmStringComponentCreate
Text File  |  1998-10-30  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttCCCCrrrreeeeaaaatttteeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttCCCCrrrreeeeaaaatttteeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttCCCCrrrreeeeaaaatttteeee - A compound string function that
  10.           creates arbitrary components
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           XXXXmmmmSSSSttttrrrriiiinnnngggg XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttCCCCrrrreeeeaaaatttteeee(
  15.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee cccc____ttttyyyyppppeeee,
  16.           uuuunnnnssssiiiiggggnnnneeeedddd iiiinnnntttt lllleeeennnnggggtttthhhh,
  17.           XXXXttttPPPPooooiiiinnnntttteeeerrrr vvvvaaaalllluuuueeee);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttCCCCrrrreeeeaaaatttteeee creates a new XXXXmmmmSSSSttttrrrriiiinnnngggg component of
  24.           type _c__t_y_p_e, containing _v_a_l_u_e. If _v_a_l_u_e is invalid for the
  25.           particular component type, this function fails and returns
  26.           NULL.
  27.  
  28.           _c__t_y_p_e    Specifies the type of component to be created.
  29.  
  30.           _l_e_n_g_t_h    Specifies the length in bytes of _v_a_l_u_e.  Note that
  31.                     this must be precisely the length of the
  32.                     _v_a_l_u_estring, _n_o_t including any trailing null
  33.                     characters.
  34.  
  35.           _v_a_l_u_e     Specifies the value to be used in the creation of
  36.                     the component.
  37.  
  38.           Refer to the XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee(3) reference page for a
  39.           list of the possible XXXXmmmmSSSSttttrrrriiiinnnngggg component types.
  40.  
  41.      RRRREEEETTTTUUUURRRRNNNN
  42.           If _v_a_l_u_e is invalid for _c__t_y_p_e, fails and returns NULL.
  43.           Otherwise, this function returns a new compound string.
  44.           When the application no longer needs the returned compound
  45.           string, the application should call XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee.
  46.  
  47.      RRRREEEELLLLAAAATTTTEEEEDDDD
  48.           XXXXmmmmSSSSttttrrrriiiinnnngggg(3), XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttTTTTrrrriiiipppplllleeee, XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCoooommmmppppoooonnnneeeennnnttttTTTTyyyyppppeeee,
  49.           and XXXXmmmmSSSSttttrrrriiiinnnnggggFFFFrrrreeeeeeee(3).
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.